home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 11 / Cream of the Crop 11-2.iso / os2 / gnucal.zip / README < prev    next >
Text File  |  1995-12-20  |  7KB  |  158 lines
  1. This is the file README for the `gcal' distribution, version 0.39.
  2.  
  3.  
  4. `gcal' displays both month and year calendar sheets, eternal holiday lists
  5. and fixed date warning lists; in many ways.  `gcal' correctly omits the dates
  6. that were skipped when the current Gregorian calendar replaced the earlier
  7. Julian calendar.
  8.  
  9. Its main advantages over BSD-`cal' and `calendar' are:
  10.   - Some special calendar sheet formats.
  11.   - Variable number of year calendar sheet blocks.
  12.   - Adjustable highlighting of holidays and actual day.
  13.   - Variable starting day of week.
  14.   - Output of Julian days, concatenated standard days and Julian days.
  15.   - Output of fiscal years.
  16.   - Output of month and year lists or ranges.
  17.   - Sorted output of eternal holiday lists, which are generated automatically.
  18.   - Sorted output of fixed date warning lists in MANY ways.
  19.   - Allows the use of date variables.
  20.   - Fixed date warning messages can be stored in several files.
  21.   - Default options can be stored in environment variable GCAL.
  22.   - Options and commands stored in response files can be preloaded.
  23.   - Uses either an external pager or a simple built-in pager.
  24.   - Detailed Texinfo reference manual.
  25.   - German, English and American version.
  26.   - Supports various computer platforms.
  27.   - Autoconf(igure) installation technology.
  28.   - Supports both UN*X short style options and GNU long style options.
  29.  
  30.  
  31. System requirements:
  32. --------------------
  33.   Compiler         : any? [ANSI] C compiler (GCC, TCC, BCC, MSC, ZTC,
  34.                        WCC, XLC, []CC...)
  35.   Computer         : MS-DOS PC, OS/2 PC, Linux PC, Acorn, Atari ST,
  36.                        Amiga, Vax, most UN*X Workstations, perhaps
  37.                        some Mainframes
  38.   RAM              : below 250 KByte(UN*X/OS2/MS-DOS) load size
  39.   Graphics adapter : none
  40.   Device driver    : [n]ansi.sys/ansi-terminal recommended, but not essential
  41.   Harddisk         : none
  42.  
  43.  
  44. Limitations:
  45. ------------
  46.   Date must be after 0 and before 10000 (year in range 1..9999).
  47.     >  The current Gregorian calendar year is actually about 26.3 seconds
  48.     >  longer than the solar year, which means that by 4316 the calendar
  49.     >  will be one day ahead of the sun.
  50.     >  Some sort of correction obviously MUST be made.
  51.   I know that there will be an adjustment of some kind in 4316, but I am not
  52.   sure what it is to be.  So I don't respect this correction in `gcal' yet !
  53.  
  54.  
  55. Some planned features are not supported yet (see the file TODO).
  56. See the file NEWS for a summary of changes since version 0.28 or HISTORY
  57. for a complete summary of changes.  See the file INSTALL and SYMBOLS for
  58. compilation and installation instructions.  Some answers to frequently
  59. asked questions are given in the file INSTALL, please read it.  A list of
  60. all know bugs can be found in the BUGS file.  Inspect MANIFEST for a list
  61. of all files which are part of this distribution.
  62.  
  63.  
  64. If you use the GNU Autoconf technology, you can enable/disable several
  65. package options by calling the `configure' script with `--enable-FEATURE'
  66. `--disable-FEATURE' arguments.  These arguments are:
  67.  
  68.     --enable-feature=DIGIT+DIGIT+... where DIGIT is 1...6
  69.  
  70. (1) --enable-cath    Additional Catholic holidays.
  71. (2) --enable-debug   Includes some debugging code.
  72. (3) --enable-easci   Displaying using the extended ASCII character set.
  73. (4) --enable-ger     German texts, holidays and calendar style.
  74. (5) --enable-ushdy   U.S. specific holidays.
  75. (6) --enable-exit127 On help etc. terminate with exit status 127.
  76.  
  77.     --enable-greg-ref=YEAR  Year of Gregorian reform, either 1582 or 1752.
  78.  
  79.     --disable-hls    Never use highlighting sequences.
  80.     --disable-pager  Never use external or simple, internal pager feature.
  81.     --disable-rc     Never use fixed date warnings feature.
  82.     --disable-term   Never use libtermcap or libtermlib.
  83.  
  84. Here are some sample calls of configure script:
  85.  
  86.   ./configure --enable-feature=1+5+6                (for American users)
  87.   ./configure --enable-feature=1+6 --enable-ushdy   (same as above)
  88.   ./configure --enable-feature=1+4+6                (for German users)
  89.   ./configure --enable-feature=1+3+4+6              (for German Linux users)
  90.   ./configure --disable-term --enable-feature=...   (work around Termcap bug)
  91.  
  92. Some words on how `gcal' will manage the Gregorian reformation:
  93.  
  94. If you configure `gcal' for English users, the year of Gregorian
  95. reformation is automatically set to 1752 and there is no need to
  96. use the `--enable-greg-ref=1752' option.  But if you want to burn-in
  97. the alternative year the Gregorian reformation have occured, run
  98. `configure' in this way:
  99.  
  100.   ./configure --enable-greg-ref=1582 ...
  101.  
  102. If you configure `gcal' for German users, the year of Gregorian
  103. reformation is automatically set to 1582 and there is no need to
  104. use the `--enable-greg-ref=1582' option.  But if you want to burn-in
  105. the alternative year the Gregorian reformation have occured, run
  106. `configure' in this way:
  107.  
  108.   ./configure --enable-ger --enable-greg-ref=1752 ...
  109.  
  110.  
  111. This program does not require Termcap, but takes advantage of it
  112. when it is available.  You may want to get and install GNU Termcap
  113. first from /@prep.ai.mit.edu:pub/gnu/termcap-1.2.tar.gz, or better.
  114.  
  115.  
  116. Please send all comments and bug reports via electronic mail to:
  117.  
  118.    Thomas Esken <esken@uni-muenster.de>
  119.  
  120. or, if this fails, to bug-gnu-utils@prep.ai.mit.edu.
  121.  
  122. Bug reports should ideally include:
  123.     * The complete output of "gcal --version" (or the contents of gcal_def.h
  124.         and the Makefile if you can't get `gcal' to compile)
  125.     * The hardware and operating system (try "uname -a")
  126.     * The compiler used to compile (if it is gcc, use "gcc -v")
  127.     * A description of the bug behavior
  128.     * The command line given to `gcal', that triggered the bug
  129.  
  130.  
  131. `gcal' is free software, you can redistribute it and/or modify it under
  132. the terms of the GNU General Public License as published by the `Free
  133. Software Foundation'; either version 2, or (at your option) any later
  134. version.  A copy of this license is provided under the name COPYING.
  135.  
  136.  
  137. The latest version of `gcal' is always available by ftp in
  138. prep.ai.mit.edu:/pub/gnu, or in any of the prep mirror sites:
  139.  
  140. - sources in gcal-*[.tar or .tar.Z or .tar.gz or .zip or .shar].
  141.  
  142.  
  143. The latest MSDOS sources/executables are always available from
  144. SimTel, the Coast to Coast Software Repository (tm), (available
  145. by anonymous ftp from the primary mirror site OAK.Oakland.Edu
  146. and its mirrors):
  147.  
  148. - SimTel/msdos/deskaccs/gcal-*.zip
  149. - SimTel/msdos/unixlike/gcal-*.zip
  150.  
  151.  
  152. Some ftp servers can automatically make a tar.Z from a tar file.
  153. If you are getting `gcal' for the first time, you can ask for a
  154. tar.Z file instead of the much larger tar file.
  155.  
  156. Many thanks to those who provided me with bug reports and feedback.
  157. See the files THANKS and HISTORY for more details.
  158.